package com.dbh.alg.algorithm.hot100.回溯;

import org.apache.commons.codec.BinaryDecoder;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
 * 给定一个仅包含数字 2-9 的字符串，返回所有它能表示的字母组合。答案可以按 任意顺序 返回。
 *
 * 给出数字到字母的映射如下（与电话按键相同）。注意 1 不对应任何字母。
 *
 *
 *
 *
 *
 * 示例 1：
 *
 * 输入：digits = "23"
 * 输出：["ad","ae","af","bd","be","bf","cd","ce","cf"]
 * 示例 2：
 *
 * 输入：digits = ""
 * 输出：[]
 * 示例 3：
 *
 * 输入：digits = "2"
 * 输出：["a","b","c"]
 *
 *
 * 提示：
 *
 * 0 <= digits.length <= 4
 * digits[i] 是范围 ['2', '9'] 的一个数字。
 */
public class Leetcode17_电话号码的字母组合 {

    public List<String> letterCombinations(String digits) {
        // 初始化结果列表，用于存储所有可能的字母组合
        List<String> combinations = new ArrayList<>();

        // 处理输入为空的情况
        if (digits.isEmpty()) {
            return combinations;
        }

        // 建立数字到字母的映射（电话键盘布局）
        Map<Character, String> phoneMap = new HashMap<>();
        phoneMap.put('2', "abc");
        phoneMap.put('3', "def");
        phoneMap.put('4', "ghi");
        phoneMap.put('5', "jkl");
        phoneMap.put('6', "mno");
        phoneMap.put('7', "pqrs");
        phoneMap.put('8', "tuv");
        phoneMap.put('9', "wxyz");

        // 调用回溯方法，从索引0开始构建组合
        backtrack(combinations, phoneMap, digits, 0, new StringBuffer());
        return combinations;
    }

    /**
     * 回溯方法，递归生成所有可能的字母组合
     * @param combinations 结果列表
     * @param phoneMap 数字到字母的映射
     * @param digits 输入的数字字符串
     * @param index 当前处理的数字索引
     * @param combination 当前构建的字母组合
     */
    private void backtrack(List<String> combinations, Map<Character, String> phoneMap, String digits, int index,
                           StringBuffer combination) {
        // 终止条件：已经处理完所有数字，将当前组合加入结果列表
        if (index == digits.length()) {
            combinations.add(combination.toString());
        } else {
            // 获取当前数字
            char digit = digits.charAt(index);
            // 获取当前数字对应的字母字符串
            String letters = phoneMap.get(digit);
            // 遍历当前数字对应的每个字母
            int lettersCount = letters.length();
            for (int i = 0; i < lettersCount; i++) {
                // 选择当前字母，加入组合
                combination.append(letters.charAt(i));
                // 递归处理下一个数字
                backtrack(combinations, phoneMap, digits, index + 1, combination);
                // 回溯：移除最后添加的字母，尝试其他可能性
                combination.deleteCharAt(index);
            }
        }
    }

}
